home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / microbat.zip / MB.DOC < prev    next >
Text File  |  1991-01-21  |  17KB  |  343 lines
  1. Document for MicroMacroBat....................................................
  2.  
  3. MB.EXE is a program which when run with an argument on the command line, from
  4. either the DOS prompt or within a batch file, performs the operations specified
  5. by that argument.  For example, by typing or placing this line in a batch
  6. file or on the command line:
  7.  
  8. MB BOX/1/1/12/80/1/112
  9.  
  10. MicroMacroBat will perform the operation specified by the argument
  11. BOX/1/1/12/80/1/112. The argument tells MicroMacroBat to place a BOX with the
  12. upper left corner at row 1, column 1, the lower right corner at row 12,
  13. column 80, use the single line box character and make the color black on
  14. white.
  15.  
  16. MicroMacroBat can be a very handy extention to your batch file writing tools
  17. without having to learn a new batch-file-writing language or performing
  18. a compilation.
  19.  
  20. MB.EXE can be tucked away in your utilities directory with a "path" pointing
  21. to it.  MicroMacroBat calls may be intermixed with the batch file routines you
  22. normally use without any further consideration other than proper syntax usage.
  23.  
  24. MicroMacroBat will have many uses:
  25.  
  26. *             In your AUTOEXEC.BAT files.
  27. *             In distribution disc BAT files for hard drive installations.
  28. *             In BAT files for making file backups.
  29. *             In BAT files for demonstration programs and slide shows.
  30. *             For Shareware distributors GO files.
  31. *             BLOADable screen design.  See note 3 under REGISTRATION.
  32.  
  33. DEMO.BAT is a batch file which demonstrates some of the routines and contains
  34. some important remarks.
  35.  
  36. NOTE:  In order that MB can load and execute as quickly as possible, syntax
  37. .      and error checking are non-existent.  Make no errors and you will have
  38. .      no problems.
  39.  
  40. The ONLY legal argument separator is the "/".  DO NOT use anything else.
  41. Either upper or lower case text is acceptable.  Remember, each line is to
  42. be prefixed with MB, followed by a space and the argument, ie:
  43.  
  44. .                        MB BOX/1/1/12/80/1/31
  45.  
  46. The following is a list of supported arguments, their proper syntax and an
  47. explanation of what the operation does.  The meaning of the parameter TEXT$
  48. is:  Any group of ASCII characters in the range of 0 to 255.
  49.  
  50.  
  51. BOX/BR/BC/ER/EC/CHARACTER/COLOR/C       Draws a box where BR is the beginning
  52. .                                       row, BC the beginning column, ER the
  53. .                                       ending row, EC the ending column where
  54. .                                       BR < ER, BC < EC and COLOR < 256.
  55. .                                       CHARACTER is either 1 or 2 indicating
  56. .                                       a single or double line box.  COLOR
  57. .                                       is a single value representing the
  58. .                                       foreground and background colors.  See
  59. .                                       the single color chart below.  The
  60. .                                       values for   BR,  BC,  ER  and  EC
  61. .                                       should be within the allowable limits
  62. .                                       as dictated by the lines/columns mode
  63. .                                       of your monitor.  Appending /C to the
  64. .                                       argument clears the inside of the box
  65. .                                       to the background color specified in
  66. .                                       the COLOR argument.
  67. .                           Example:    BOX/1/5/12/75/1/79 draws a single-line
  68. .                                       box with the upper left corner at row
  69. .                                       1, column 5, the lower right corner at
  70. .                                       row 12 column 75 in bright white on
  71. .                                       red and not cleared.
  72.  
  73. CLEARSCR/BR/BC/ER/EC/COLOR              Clears an area of the screen where BR,
  74. .                                       BC, ER, EC and COLOR have the meanings
  75. .                                       as described above.
  76. .                           Example:    CLEARSCR/1/5/12/75/31
  77.  
  78. BLOAD/FILENAME$                         BLOADS a file into video memory as
  79. .                                       the BASIC's BLOAD command.  The area
  80. .                                       of video memory the file is loaded into
  81. .                                       is automatically determined by the
  82. .                                       monitor in use.  This command is for
  83. .                                       "slide shows" of predetermined screen
  84. .                                       files made with Basic's BSAVE or a
  85. .                                       screen capture utility.
  86. .                           Example:    BLOAD/MAINMENU.SCR
  87.  
  88. FILLSCRN/BR/BC/ER/EC/COLOR/ASCII        Fills the screen with the character
  89. .                                       represented by the value ASCII.  BR,
  90. .                                       BC, ER, EC and COLOR are as previously
  91. .                                       described.
  92. .                           Example:    FILLSCRN/1/5/12/75/30/45 will fill the
  93. .                                       described area with dashes colored
  94. .                                       yellow on blue.
  95.  
  96. PAINT/BR/BC/ER/EC/COLOR                 Paints the screen without disturbing
  97. .                                       the existing text.
  98. .                           Example:    PAINT/1/5/12/75/7
  99.  
  100. OCPRINT/ROW/COLUMN/TEXT$/COLOR          Same as PRINT, below, except that
  101. .                                       printing takes place slowly; one
  102. .                                       character at a time, for effect.
  103.  
  104. PRINT/ROW/COLUMN/TEXT$/COLOR            Rapidly prints TEXT$ in COLOR at the
  105. .                                       ROW/COLUMN.  TEXT$ will be displayed
  106. .                                       exactly as entered, including quotes
  107. .                                       if used.  Extended ASCII characters
  108. .                                       may be displayed. The routine writes
  109. .                                       to video memory; no line feed issued.
  110. .                           Example:    PRINT/5/1/display these words/31
  111.  
  112. CURSOROFF                               Turns the cursor off.  Be sure to turn
  113. .                                       the cursor back on at the end of the
  114. .                                       bat file.
  115.  
  116. CURSORON                                Turns the cursor on.
  117.  
  118. LOCATE/ROW/COLUMN                       Locates the cursor at ROW/COLUMN.
  119. .                                       Handy if you want to use the ECHO
  120. .                                       command.  Printing by DOS will begin
  121. .                                       at the cursor position.
  122. .                           Example:    LOCATE/1/1
  123.  
  124. WAIT                                    Suspends operation and waits for a
  125. .                                       keypress.
  126.  
  127. CHIME/WHICHONE                          Makes a chime-like tone.  WHICHONE
  128. .                                       must be in the range of 1 to 10.
  129. .                           Example:    CHIME/7
  130.  
  131. SLEEP/SECONDS                           Suspends operation until SECONDS
  132. .                                       seconds elapses.
  133. .                           Example:    SLEEP/4
  134.  
  135. STUFF/TEXT$                             Stuffs text into the keyboard buffer,
  136. .                                       appending an <ENTER> keypress.
  137. .                                       To simulate pressing <ENTER>, simply
  138. .                                       use STUFF without parameters.  TEXT$
  139. .                                       CANNOT be more than 15 characters.
  140. .                           Example:    STUFF/Y
  141.  
  142. USCROLL/BR/BC/ER/EC/TIMES               Provides for scrolling of a selected
  143. DSCROLL/BR/BC/ER/EC/TIMES               area of the screen, either Up, Down,
  144. LSCROLL/BR/BC/ER/EC/TIMES               Left or Right, TIMES times.
  145. RSCROLL/BR/BC/ER/EC/TIMES
  146. .                           Example:    LSCROLL/1/1/12/80/4
  147.  
  148. FAD